home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 015 / smalldoc.arc / SMALLDOC.DOC next >
Text File  |  1987-09-29  |  12KB  |  234 lines
  1.  
  2.           "SMALLDOC" documentation and CONFIGURATION file combination
  3.  
  4.    SMALLDOC.exe makes "SMALL" pages of ascii "DOC"umentation (.DOC) files.
  5.  
  6. As stated in the line above, the reason the  program  exists is to take  those
  7. ".DOC"   and  ".TXT"   files that accompany the SHAREWARE  and  PUBLIC  DOMAIN
  8. programs and to produce a small-sized document that will fit in the three ring
  9. notebooks  which are the same size as the IBM BASIC book or many of the  other
  10. same  size small book/slip cover sets.   SMALLDOC provides the lines to cut on
  11. and marks the positions where to punch the three holes.
  12.  
  13. For  document  files that are ALREADY formatted,  SMALLDOC simply REDUCES  the
  14. size and adds the margin on the left side for the holes to be punched.
  15.  
  16. SMALLDOC will convert any Unprintable, Justify characters (FF) to blanks (20).
  17.  
  18. For those document files that seem to go ON and ON FOREVER without  formatting
  19. then  SMALLDOC will allow you to put a HEADER on each page and then each  page
  20. can be NUMBERED or NOT as you choose.   This file is one of those ".DOC" files
  21. that  are  not  formatted  and seem to go ON and  ON  forever.    If  you  run
  22. "SMALLDOC" and process this file, you probably would want to have a HEADER and
  23. NUMBER the pages, too.
  24.  
  25. While you are printing,  if you touch the  "P" key then you can halt printing.
  26. This  feature  is to provide you the ability to stop the printer  so  you  can
  27. answer the phone.
  28.  
  29. If you enter the letters "Q" or "q"  when you're prompted to enter a file name
  30. then you will QUIT.
  31.  
  32. If you enter the words "MAKE FORMAT"  or "make format"  when asked for a  file
  33. name,  then a  sample format will be made so that you can use it to change the
  34. numbers in the CONFIGURATION part below (between the star-lines *****).  It is
  35. a  guide only and you should not use it as the final authority.   It is better
  36. to use TRIAL and ERROR in the star-line variables in order to fine tune.
  37.  
  38. NOTE: You can put the name of the file to print and most  of the options after
  39. the filename SMALLDOC on the command line.   For more instructions,  enter the
  40. following at your prompt [example] C:>SMALLDOC HELP   <ENTER>    and you  will
  41. get a small screen of instructions for future sessions.   First,  though,  you
  42. should  attempt to run the program "plain vanilla"  by typing just SMALLDOC at
  43. the prompt [example] A:>SMALLDOC <ENTER> and then follow the MENU options.
  44.  
  45. SMALLDOC will NOT handle WORDSTAR or Binary files where ASCII characters  have
  46. values  above 127  (the famous HIGH BIT).   If you want to produce a  SMALLDOC
  47. page of a WORDSTAR or any NON "low-ASCII" file, then use a suitable program to
  48. accomplish that feat first (no pun intended).
  49.  
  50. --------------------------------------NOTE--------------------------------------
  51.  
  52. If this file, SMALLDOC.DOC, cannot be found when the main program SMALLDOC.EXE
  53. is  run (heavens forbid!)  then EPSON printer codes will be used and you  will
  54. have to use  the values that are hard-coded in the program.  This SMALLDOC.DOC
  55. file is an ASCII  file can be editted by almost any WORD PROCESSOR so that you
  56. can  easily change the values to suit yourself and your printer.   If you HAVE
  57. TO, then use the DOS "EDLIN" program to edit SMALLDOC.DOC (arghhhhh!!!!!!).
  58.  
  59. ------------------------------------------------------------------------------
  60.  
  61.  
  62.                             HERE ARE THE STAR-LINES
  63.  
  64. *****************************24*numbered*lines**************starline#1********
  65. 1-  THE NUMBER OF LINES FOR THE TOP MARGIN = 3
  66. 2-  THE NUMBER OF LINES FOR THE BOTTOM MARGIN = 2
  67. 3-  THE WIDTH OF PAGE = 96
  68. 4-  THE NUMBER OF LINES PER PAGE = 66
  69. 5-  THE LINE NUMBER OF THE TOP PUNCH HOLE = 12
  70. 6-  THE LINE NUMBER OF THE MIDDLE HOLE    = 35
  71. 7-  THE LINE NUMBER OF THE BOTTOM HOLE    = 57
  72. 8-  ASCII CODE FOR THE HOLE DESIGN (PLUS MARK +) = 43
  73. 9-  ASCII CODE FOR THE HEADER LINE (DASH -) = 45
  74. 10- ASCII CODE FOR VERTICAL LINE TO CUT ON AT THE RIGHT EDGE (PERIOD .) = 46
  75. 11- ASCII CODE FOR HORIZONTAL LINE TO CUT ON AT THE BOTTOM EDGE (PERIOD .) = 46
  76. 12- THE NUMBER OF LINES OF SPACING BETWEEN RIGHT EDGE DESIGN, #10 ABOVE = 4
  77. 13- THE NUMBER OF SPACES BETWEEN THE BOTTOM EDGE DESIGN, #11 ABOVE = 5
  78. 14- THE WIDTH OF THE LEFT MARGIN = 10
  79. 15- WHERE IN THE LEFT MARGIN TO PUT HOLES (must be less than value in #14) = 2
  80. 16- PRINTER CODE(S) TO MAKE COMPRESSED PRINT (use commas if needed) = 15
  81. 17- PRINTER CODES FOR VERTICAL SPACING CLOSER (use commas) = 27, 51, 26
  82. 18- PRINTER CODES TO TURN DOUBLE WIDE PRINT ON  (use commas) = 27, 87, 1
  83. 19- PRINTER CODES TO TURN DOUBLE WIDE PRINT OFF (use commas) = 27, 87, 0
  84. 20- PRINTER CODES TO RESET PRINTER TO NORMAL CONDITION (use commas) = 27, 64
  85. 21- DURATION (in seconds) FOR THE INITIAL "READING SMALLDOC.DOC" MESSAGE = 2
  86. 22- YOUR NAME IN THE FINAL MESSAGE, "COMPLIMENTS OF" =Roger Taylor, Jr.
  87. 23- SOUND EFFECTS SWITCH (ON or OFF) = ON
  88. 24- AUTOMATIC CAPS LOCK KEY (ON or OFF) = ON
  89. ************************************************************starline#2********
  90.  
  91.             DO NOT REMOVE THE ABOVE 2 "STARLINES" OF STARS (*****).
  92.  
  93.                                KEEP READING....
  94.  
  95. CHANGE THE ABOVE VALUES AND CODES BETWEEN THE TWO STARLINES TO SUIT YOU AND TO
  96. SUIT YOUR PRINTER.   WHEN THESE VALUES ARE READ BY THE "SMALLDOC.EXE" PROGRAM,
  97. IT USES LOGIC TO FIND THE EQUALS MARK "="  AND THE COMMAS ","  TO KNOW HOW  TO
  98. FIND THE VALUES.  DO NOT CHANGE THE  ORDER OF THE LINES.   THERE ARE 24 ITEMS.
  99.  
  100. FOR EXAMPLE, IF YOU DON'T WANT SOUND EFFECTS, USE  ANY  WORD PROCESSOR TO MAKE
  101. THE LINE 23 ABOVE TO READ:
  102.  
  103. 23- SOUND EFFECTS SWITCH (ON or OFF) = OFF
  104.  
  105. ------------------------------------------------------------------------------
  106.  
  107. NEXT, COMES THE EXPLANATION OF THE 24 VALUES, CODES, or VARIABLES:
  108.  
  109.  
  110. Variable #1 is how many blank lines to put at the top of the small page before
  111. you start printing anything.  It is the Top Margin.
  112.  
  113. Variable #2  is how many blank lines do you want to put at the bottom  between
  114. the text and the bottom edge of the small document page.
  115.  
  116. Variable  #3   is the width of the page after it has been put into  compressed
  117. print.   A  small page is about 6 inches wide.   At 17  cpi,  it will hold 102
  118. characters which is more than enough to make a small page.
  119.  
  120. Variable #4 is the number of Lines Per Page.  Typically, this number is 66.
  121.  
  122. Variables #5, #6, and #7 define which lines must print the three hole marks to
  123. help you punch the three holes for use in a binder.
  124.  
  125. Variable #8 defines the DESIGN for the "hole marks". An ASCII 43 is "+".
  126.  
  127. Variable #9 defines the ASCII character (45) used for printing the Header Line
  128. (------) . Another character you might like to use is the Equals Mark (======)
  129. which is 61.
  130.  
  131. Variables #10  and #11  are the characters (originally periods ".")  that  are
  132. used to print the document edges so you will know where to cut.
  133.  
  134. Variable #12  defines how frequently to print the character defined by #10  at
  135. the RIGHT edge of the small page to be made (i.e. 4 means every 4 lines).
  136.  
  137. Variable #13  defines how frequently to print the character defined by #11  at
  138. the bottom of the small page (i.e. 5 means every 5 spaces).
  139.  
  140. Variable #14 is the Width of the Left Margin, i.e.  how thick to make a margin
  141. so you can punch holes in it safely without having a hole in the text.
  142.  
  143. Variable #15  is Where, inside the Width of the Left Margin, that you want the
  144. HOLE design to print. Example: If the Left Margin is 10  and you want the HOLE
  145. DESIGN (+) to print in the middle of it, then make this variable = 5.
  146.  
  147. Variable #16  is the code(s)  to make the printer print in compressed print of
  148. about 17 characters per inch (17 cpi).  Some printers go 16.66  cpi which will
  149. be fine.  Refer to your Printer Manual for this code or codes.
  150.  
  151. Variable #17 is the code (or codes) for the printer to use to make the printer
  152. print lines closer together than the normal 6 or 8 lines per inch  vertically.
  153. You must obtain these codes from your Printer Manual.
  154.  
  155. Variables #18  and #19  turn the double wide printing on/off.   You should use
  156. the  set of codes for your printer that allows this feature to be turned  both
  157. ON and OFF on a SINGLE line,  WITHIN the line.   If your printer does not have
  158. this feature then use 32, 32  for the codes since printers can print the space
  159. character 32.  If you use 32, of course, you will not get DOUBLE WIDE printing
  160. of the HEADER.
  161.  
  162. Variable #20  cannot be used on some printers.   Most printers,  however,  can
  163. be RESET to normal after printing "fancy".  EPSON uses ESC,"@" or 27, 64.
  164. IF YOUR PRINTER CANNOT DO A RESET THEN MAKE THE CODE EQUAL TO 255 (i.e. = 255)
  165. SINCE MOST PRINTERS CANNOT PRINT ASCII 255.   IF THAT STILL DOES NOT WORK, YOU
  166. COULD USE 32 (WHICH IS A SPACE).
  167.  
  168. Variable #21  is the duration in seconds for the FIRST MESSAGE seen.  This may
  169. be set to zero if you read fast.
  170.  
  171. Variable  #22   is  where  you will put YOUR name if you  want  to  give  away
  172. SMALLDOC.EXE and this  combination DOCUMENTATION/CONFIGURATION file.  SMALLDOC
  173. comes from the author with the author's name in it.
  174.  
  175. Variable #23  lets you have SOUND EFFECTS or NOT.  (Nelson Ford will have this
  176. set to OFF.)
  177.  
  178. Variable  #24  turns on (or off)  the CAPS LOCK KEY so that you will be typing
  179. your  Headers  automatically  in  all CAPITAL LETTERS  instead  of  having  to
  180. remember  to press the CAPS LOCK KEY before you type.   I  recommend that  you
  181. leave  this  variable  set  to ON.  (it uses DEF SEG=64:poke  23,64   for  you
  182. programmers out there.)
  183.  
  184. HERE IS A "PICTURE" OF WHERE SOME OF THE VARIABLES ARE - ON A SMALLDOC-ed PAGE
  185.  
  186. "#1" IS THE "TOP MARGIN", ETC.  Look between the starlines (*****) above
  187.     to reference the numbers #1 thru #24.
  188.  
  189. -------------------------------------#3--------->    #3 is width of page
  190. :                   #1                          .    #1 is top margin
  191. :      xxxxxxxxtextxxxxxxxxxxxxxxtextxxxxxxxx              (how many lines)
  192. : #5   xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  193. :  +   <--- the "+" marks a punch hole xxxxxx   .    #5 is top hole line
  194. :      xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx                       number
  195. :      xxxtextxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  196. :      xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx   .<------- Right Edge Dot(.)
  197. : #6   xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  198. :  +   xxxxxxxxxxxxxxxxxxxxxxxxxxtextxxxxxxxx        #6 is middle hole line
  199. :      xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx   .                    number
  200. :      xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  201. :      xxxxxxxxxxxxtextxxxxxxxxxxxxxxxxxxxxxx
  202. : #7   xxxxxxxxxxxxxxxxxxxxxxxxxxxtextxxxxxxx   .
  203. :  +   xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx        #7 is bottom hole line
  204. :      xxtextxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx                        number
  205. :      xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx   .
  206. :                         #2
  207. :.   .    .    .    .    .    .    .    .    .    .    .#2 is bottom margin
  208.           ^                                                (how many lines)
  209.           ^
  210.           ^Bottom Edge (.)
  211.  
  212.  
  213. The  variables should be untouched until you have run the program a few  times
  214. and have decided that you really can't stand the ASCII symbols and the spacing
  215. that I have chosen.
  216.  
  217. ---------------------------------- WARE TYPE ---------------------------------
  218.  
  219. This is not SHAREWARE.  This is LUNCHWARE.  If you like this program, then put
  220. YOUR  name in the "COMPLIMENTS OF"  SECTION  (item #22)  and take a friend  to
  221. lunch,  give them a copy,  and discuss how "wonderful"  it is.  That is enough
  222. payment for me.  I hope you can use it.
  223.  
  224. SMALLDOC.EXE was written in BASICA and compiled with QUICK BASIC version 2.0.
  225.  
  226. -------------- DAVID ROPER - P. O. BOX 680 - GARNER, N. C. 27529 -------------
  227.  
  228. The following line is put at the end of this file for those people with MODEMS
  229.          THE END  -  You have received all of SMALLDOC.DOC  -  THE END
  230.  
  231.  
  232.  
  233. 
  234.